home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / bootpicturetools / aws / aws.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  7KB  |  170 lines
  1. @database AWS.guide
  2. @$VER: AWS.guide 1.0 (2.11.94)
  3. @node main "AWS Documentation - Contents"
  4.                           AmigaWorkStation V1.5
  5.                 Copyright 
  6.  1994 Paul Hernik & Adam Bakalarz
  7.                             All Rights Reserved.
  8.                   @{" DESCRIPTION  " link DESCRIPTION}
  9.                   @{" SYNTAX       " link SYNTAX}
  10.                   @{" HOW TO USE   " link HOW_TO_USE}
  11.                   @{" PALETTES     " link PALETTES}
  12.                   @{" A2024        " link A2024}
  13.                   @{" AUTHORS      " link AUTHORS}
  14.                   @{" DISTRIBUTION " link DISTRIBUTION}
  15.                   @{" HISTORY      " link HISTORY}
  16.                   @{" TESTS        " link TESTS}
  17.                   @{" TODO         " link TODO}
  18.                   @{" THANX        " link THANX}
  19. @endnode
  20. @node DESCRIPTION
  21.   DESCRIPTION:
  22.   This  utility  opens  Windows  like  screen during boot and shows some
  23.   information  about  your  machine:  CPU, FPU, GFX Chips, video system,
  24.   Kickstart  version,  memory,  current  time  and date.  You can change
  25.   palette  from 8 presets, monitor/screen mode and select hour system if
  26.   you want.
  27. @endnode
  28. @node SYNTAX
  29.   SYNTAX:
  30.    OpenAWS [-options]
  31.    -a        : alternative font
  32.                better for interlace if you haven't ficker fixer
  33.    -c<x,y>   : position x,y; x=0-220, y=0-60
  34.                default: 111,30 for PAL and 111,28 for NTSC
  35.    -h<12|24> : selects 12 or 24 hour system, default: 24
  36.    -k<0|1>   : KB/MB switch, 0-MB, 1-KB, default: 1
  37.    -l<0|1>   : PowerLED on/off, 0-off, 1-on, default: 0
  38.    -m<ModeID>: monitor/screen mode ID, default: $8004 (default monitor)
  39.                type -ma9004 (or -m$a9004 or -m0xa9004) for DblPAL
  40.                     -m99004 (or -m$99004 or -m0x99004) for DblNTSC
  41.                     -m29004 for PAL on NTSC Amiga
  42.                     -m19004 for NTSC on PAL Amiga
  43.                for more monitor IDs look at graphics/modeid.i
  44.    -p<0-8>   : selects 8 palette presets (0-random), default: 1
  45.    -t        : AWS screen test (to exit press LMB, ESC or F1)
  46.    -u<cols>  : user palette: 16 or less HEX values
  47.    -x        : close AWS screen (works like CloseAWS)
  48.    -?        : help
  49.   Example:
  50.   OpenAWS -a -h12 -u000,012,046,068,38A,49B,3AC,4CE,00C,05A,06A,990,CC0,FF0,FFF,D00
  51.   Video  mode  and  gfx  chipset  are  taken  from  graphics.library not
  52.   from hardware registers because in OS3.0 you can select them from boot
  53.   menu and AWS will show this selection.
  54. @endnode
  55. @node HOW_TO_USE
  56.   HOW TO USE:
  57.   Take proper version of OpenAWS, change its name and copy to C: dir.
  58.   To activate AWS add 2 lines in your startup-sequence:
  59.   OpenAWS -p2 -a            (after SetPatch)
  60.   CloseAWS or OpenAWS -x    (between LoadWB and EndCLI)
  61.   AWS  works  only under OS2.x and 3.x+, doesn't require any library but
  62.   may crash if you put OpenAWS before SetPatch.
  63.   AWS  can  use  all  monitor  modes  but  proper monitor driver must be
  64.   started before OpenAWS (except for A2024).
  65.   For example for DblPAL mode put following lines after SetPatch:
  66.   Assign >NIL: ENV: RAM:    ;must be because DblPAL monitor searches for
  67.                             ;something in ENV:
  68.   SYS:Devs/DblPAL           ;start monitor driver
  69.   OpenAWS -m$A9004          ;DblPAL+HIRES+LACE mode ID
  70.   OpenAWS  is  rather  long  program  because of gfx (384x437+fonts=over
  71.   100K)  so you can pack it.  I prefer Crunchmania 1.9t but it sometimes
  72.   makes troubles on some A1200.  Use then Imploder 4.0.  Depacking takes
  73.   time so if you have slow machine don't pack OpenAWS.
  74. @endnode
  75. @node PALETTES
  76.   DEFAULT PRESETS:
  77.   1-000,021,032,065,085,098,0A8,0DA,00C,059,068,990,CC0,FF0,FFF,D00  ;green1
  78.   2-000,212,323,757,868,979,A8A,CAC,00C,659,768,990,CC0,FF0,FFF,D00  ;violet
  79.   3-000,210,420,850,A60,B70,C80,EA2,00C,457,568,990,CC0,FF0,FFF,D00  ;brown
  80.   4-000,012,046,068,38A,49B,3AC,4CE,00C,05A,06A,990,CC0,FF0,FFF,D00  ;blue
  81.   5-000,222,333,666,777,888,999,BBB,00C,058,069,990,CC0,FF0,FFF,D00  ;gray
  82.   6-000,120,130,361,482,6A3,7B4,AE7,00C,268,378,990,CC0,FF0,FFF,D00  ;green2
  83.   7-000,200,401,934,A45,D56,E67,F9A,00C,638,749,990,CC0,FF0,FFF,D00  ;pink
  84.   8-000,222,333,666,777,888,999,BBB,00C,058,069,990,BBB,EEE,FFF,D00  ;gray2
  85.   HOW TO MAKE OWN PALETTES:
  86.   1. Type in Shell "OpenAWS"
  87.   2. Save screen using screen grabber or better Personal Paint
  88.   3. Set colors in your favourite gfx program
  89.   4. Use gfx converter (f.e. PicCon) to save palette in asm source mode
  90.      (4-bit) or write over colors from palette requester manually :-(
  91.      If you have designed nice preset or improved old send it to me.
  92. @endnode
  93. @node A2024
  94.   NOTES FOR A2024 USERS:
  95.   A2024  versions have palette options (-p and -u) disabled because this
  96.   monitor  has  always  4 default greys.
  97.   Don't  use  A2024 monitor driver before starting AWS because it is not
  98.   necesary.  AWS works in 640x???  emulation mode.
  99.   If  somebody will be interested in 1K x 1K version (via A2024 monitor)
  100.   please send to me e-mail.  We will do that!
  101. @endnode
  102. @node AUTHORS
  103.   AUTHORS:
  104.   AWS  was  written  in Devpac assembler by Paul "CBM80" Hernik, gfx was
  105.   drawn by Adam "Gunman" Bakalarz.  All comments or bug reports send to:
  106.            Paul Hernik
  107.            Nowowiejska 24/3
  108.            25-532 Kielce
  109.            POLAND
  110.            tel. (041)27012
  111.   e-mail:  spi-ph@srv1.tu.kielce.pl
  112. @endnode
  113. @node DISTRIBUTION
  114.   DISTRIBUTION:
  115.   AWS  is  FREEWARE.   You  may use and copy this program freely but all
  116.   files must be copied in an unmodified state preferably in LhA archive.
  117.   Of  course  use it on your own risk.  If you are going to install this
  118.   program and you like it send me postcard or message via e-mail.
  119. @endnode
  120. @node HISTORY
  121.   HISTORY:
  122.   1.0
  123.      simple Windows like screen
  124.   1.1
  125.      added simple information about your Amiga
  126.   1.2  
  127.      changed gfx (now by Gunman) and added some more infos
  128.   1.3  (20 Jul 94)
  129.      added parameters, first official release
  130.   1.3a (13 Sep 94)
  131.      changed screen opening and cruncher
  132.   1.4  (20 Sep 94)
  133.      added monitor mode, changed command name
  134.   1.5  (21 Oct 94)
  135.    - showing 68040 FPU in 030 systems fixed
  136.      In some A3000 and A2000 with 030 boards there is a bug in AttnFlags
  137.      FPU040 bit was set :-)
  138.    - 68060 support
  139.    - separate NTSC, A2024 PAL and A2024 NTSC versions added
  140.    - new options: PowerLED on/off, screen position, 
  141.    - new preset added - greys without yellow (especially for Joerg Plate :-))
  142. @endnode
  143. @node TESTS
  144.   AWS WAS TESTED ON FOLLOWING MACHINES:
  145.   - A4030/882 10MB RAM HD 340MB
  146.   - A2000+030/882+Retina 10MB RAM HD 1080MB (in ECS mode)
  147.   - A2000 5MB RAM HD 52MB + A2024 Monitor
  148.   - A4040 18MB RAM HD 120MB
  149.   - A1200/882 6MB RAM HD 420MB
  150.   - A1200 2MB RAM HD 420MB
  151.   - A3000 6MB RAM HD 400MB
  152.   - A3000 9MB RAM
  153.   - A3000+Merlin2 10MB RAM HD 105+340MB
  154.   - A1200/020/28Mhz
  155. @endnode
  156. @node TODO
  157.   TODO:
  158.   - Retina version (without RetinaEmu)
  159.   - maybe more infos (but there is no space on screen for them :-))
  160. @endnode
  161. @node THANX
  162.   THANX:
  163.   - Gunman for nice gfx
  164.   - H.Tweedie and Volker Friedrich for testing it on 030 systems
  165.   - Ralph Schmidt for 68060 guide
  166.   - Oliver Bausch for testing on his own gfx card and for some suggestions
  167.   - Jussi_Lindgren, Tony Leneis for ideas
  168.   - and to all people who reported me bugs and supported this program
  169. @endnode
  170.